home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / programming / mui / mcc_pkb / mcc_pkb_fi.lha / suomi / MCC_Pkb.doc next >
Text File  |  1999-04-21  |  11KB  |  497 lines
  1. TABLE OF CONTENTS
  2.  
  3. Pkb.mcc/Pkb.mcc
  4. Pkb.mcc/MUIA_Pkb_Mode
  5. Pkb.mcc/MUIA_Pkb_AutoRelease
  6. Pkb.mcc/MUIA_Pkb_Current
  7. Pkb.mcc/MUIA_Pkb_Quiet
  8. Pkb.mcc/MUIA_Pkb_Pool
  9. Pkb.mcc/MUIA_Pkb_PoolPuddleSize
  10. Pkb.mcc/MUIA_Pkb_PoolThreshSize
  11. Pkb.mcc/MUIA_Pkb_Octv_Name
  12. Pkb.mcc/MUIA_Pkb_Octv_Base
  13. Pkb.mcc/MUIA_Pkb_Octv_Range
  14. Pkb.mcc/MUIA_Pkb_Octv_Start
  15. Pkb.mcc/MUIA_Pkb_Key_Release
  16. Pkb.mcc/MUIA_Pkb_Key_Press
  17. Pkb.mcc/MUIA_Pkb_Range_Head
  18. Pkb.mcc/MUIA_Pkb_Range_Start
  19. Pkb.mcc/MUIA_Pkb_Range_End
  20. Pkb.mcc/MUIA_Pkb_Low
  21. Pkb.mcc/MUIA_Pkb_High
  22. Pkb.mcc/MUIM_Pkb_Reset
  23. Pkb.mcc/MUIM_Pkb_Refresh
  24. Pkb.mcc/MUIM_Pkb_Range
  25. Pkb.mcc/MUIM_Pkb_Range_Reset
  26. Pkb.mcc/MUIM_Pkb_Range_Refresh
  27. Pkb.mcc/MUIM_Pkb_Jump
  28. Pkb.mcc/MUIA_Pkb_InputEnable
  29. Pkb.mcc/MUIA_Pkb_ExcludeLow
  30. Pkb.mcc/MUIA_Pkb_ExcludeHigh
  31. Pkb.mcc/Pkb.mcc
  32.  
  33.    Pkb on Magic User Interfacen Custom luokka, MUI © Stefan Stuntz.
  34.    Se on Virtgroup-luokan alaluokka.
  35.  
  36.    Tämän luokan tavoite on tuoda pianokoskettimisto yleisille musiikki-
  37.    sovelluksille.
  38.  
  39.    Pkb käyttää eri värejä eri toimintotiloille, ja käyttäjä voi
  40.    vaihtaa ne MCP:llä.
  41.  
  42.    Lisätietojen saamiseksi katso esimerkkiohjelmaa.
  43.  
  44.    Demo voidaan kääntää Dice:llä tai StormC 2.0:lla.
  45.  
  46. NOTES
  47.    Ei tällä hetkellä
  48.  
  49. Pkb/MUIA_Pkb_Mode
  50.  
  51. NAME
  52.    MUIA_Pkb_Mode   -- (V1) [ISG], ULONG
  53.  
  54. FUNCTION
  55.    Asettaa tai palauttaa toimintotilan.
  56.  
  57. INPUTS
  58.    MUIV_Pkb_Mode_NORMAL   (oletus)
  59.    MUIV_Pkb_Mode_SPECIAL
  60.    MUIV_Pkb_Mode_RANGE
  61.  
  62. NOTES
  63.    Ensimmäiset kaksi tilaa poikkeavat toisistaan vain pohjaan
  64.    painettujen näppäimien värien osalta.
  65.  
  66.    Kolmatta tilaa käytetään merkitsemään joukko yhteenkuuluvia näppäimiä.
  67.    VIIMEKSI valitun ryhmän aloitusnäppäimen atribuutti on MUIA_Pkb_Range_Start
  68.    ja MUIA_Pkb_Range_End on lopetusnäppäimen atribuutti.
  69.    Tässä tilassa MUIA_Pkb_Key_Release atribuutti EI asetu, kun käyttäjä
  70.    vapauttaa hiiren viimeisellä näppäimellä.
  71.  
  72. SEE ALSO
  73.    MUIA_Pkb_Range_Head
  74.  
  75. Pkb/MUIA_Pkb_AutoRelease
  76.  
  77. NAME
  78.    MUIA_Pkb_AutoRelease   -- (V1) [ISG], BOOL
  79.  
  80. FUNCTION
  81.    Asettaa tai tunnistaa automaattisen näppäinvapautuksen.
  82.  
  83. INPUTS
  84.    -TOSI  (oletus)
  85.    -EPÄTOSI
  86.  
  87. NOTES
  88.    Jos on TOSI, näppäin vapautetaan, kun käyttäjä painaa toista näppäintä.
  89.    Jos on EPÄTOSI, näppäintä ei vapauteta, ja sen vapauttaminen on sovelluksen
  90.    päätettävissä.
  91.  
  92. SEE ALSO
  93.    MUIA_Pkb_Key_Press , MUIA_Pkb_Key_Release
  94.  
  95. Pkb/MUIA_Pkb_Current
  96.  
  97. NAME
  98.     MUIA_Pkb_Current   -- (V1) [..GN], LONG
  99.  
  100. FUNCTION
  101.    Tunnistaa käyttäjän viimeksi soittaman nuotin koodin (viimeksi painetun
  102.    näppäimen)
  103.  
  104. NOTES
  105.    Paluukoodi vaihtelee 0:n ja 131:n välillä ja on oktaavin arvosta,
  106.    joka näkyisi alapalkissa, riippumaton.
  107.  
  108. SEE ALSO
  109.    MUIA_Pkb_Octv_Start, MUIA_Pkb_Octv_Range, MUIA_Pkb_Key_Release
  110.  
  111. Pkb/MUIA_Pkb_Quiet
  112.  
  113. NAME
  114.    MUIA_Pkb_Quiet   -- (V1) [.S.], BOOL
  115.  
  116. FUNCTION
  117.    Jos on asetettu TODEKSI, niin näppäimiä ei piirretä.
  118.  
  119. SEE ALSO
  120.     MUIM_Pkb_Refresh
  121.  
  122. Pkb/MUIA_Pkb_Pool
  123.  
  124. NAME
  125.    MUIA_Pkb_Pool   -- (V1) [I.G], PoolHeader *
  126.  
  127. FUNCTION
  128.    Jätä jotain CreatePool():sta tänne, jos et halua kentän
  129.    luovan omaa muistipooliansa, vaan käyttävän tätä sensijaan.
  130.    Huomaa, että pkb-ryhmäluokka *ei* käytä semaphore-suojausta,
  131.    kun se käyttää poolia. Et saa käyttää pooleja, joita käyttävät
  132.    muutkin taskit kuin sovelluksen päätaski.
  133.  
  134. SEE ALSO
  135.     MUIA_Pkb_PoolPuddleSize, MUIA_Pkb_PoolThreshSize
  136.  
  137. Pkb/MUIA_Pkb_PoolPuddleSize
  138.  
  139. NAME
  140.    MUIA_Pkb_PoolPuddleSize   -- (V1) [I..], ULONG
  141.  
  142. FUNCTION
  143.    Määrittää kenttien memorypoolin puddlen koon.
  144.  
  145.    Oletuskoko on 2048. Sitä ei huomioida, jos käytät
  146.    omaa poolia MUIA_Pkb_Poolin avulla.
  147.  
  148. SEE ALSO
  149.     MUIA_Pkb_Pool, MUIA_Pkb_PoolThreshSize
  150.  
  151. Pkb/MUIA_Pkb_PoolThreshSize
  152.  
  153. NAME
  154.    MUIA_Pkb_PoolThreshSize   -- (V1) [I..], ULONG
  155.  
  156. FUNCTION
  157.     Määrittää kenttien memorypoolin thresh-koon.
  158.  
  159.     Oletuskoko on 1024. Sitä ei huomioida, jos käytät
  160.     omaa poolia MUIA_Pkb_Poolin avulla.
  161.  
  162. SEE ALSO
  163.     MUIA_Pkb_Pool, MUIA_Pkb_PoolPuddleSize
  164.  
  165. Pkb/MUIA_Pkb_Octv_Name
  166.  
  167. NAME
  168.    MUIA_Pkb_Octv_Name   -- (V1) [I..], BOOL
  169.  
  170. FUNCTION
  171.    Valitsee, näytetäänkö palkki koskettimiston alla.
  172.  
  173. SEE ALSO
  174.  
  175.  
  176. Pkb/MUIA_Pkb_Octv_Base
  177.  
  178. NAME
  179.    MUIA_Pkb_Octv_Base   -- (V1) [I..], ULONG
  180.  
  181. FUNCTION
  182.    Valitsee aloitusnumeron, joka näkyy palkissa koskettimiston alla.
  183.  
  184. NOTES
  185.    Varoitus: Oktaaviluku, joka näkyy palkissa ei vaikuta kosketinkoodeihin.
  186.  
  187. SEE ALSO
  188.     MUIA_Pkb_Octv_Name
  189.  
  190. Pkb/MUIA_Pkb_Octv_Range
  191.  
  192. NAME
  193.    MUIA_Pkb_Octv_Range   -- (V1) [I...], ULONG
  194.  
  195. FUNCTION
  196.    Valitsee, kuinka monta oktaavia näytetään koskettimistolla.
  197.    Hyväksyttävät arvot: 1...11
  198.  
  199. SEE ALSO
  200.  
  201.  
  202. Pkb/MUIA_Pkb_Octv_Start
  203.  
  204. NAME
  205.    MUIA_Pkb_Octv_Start   -- (V1) [I.G], ULONG
  206.  
  207. FUNCTION
  208.    Valitsee koskettimiston aloitusoktaavin.
  209.  
  210. NOTES
  211.    Varoitus: MUIA_Pkb_Octv_Start + MUIA_Pkb_Octv_Range TÄYTYY olla <= 11,
  212.    muuten MUIA_Pkb_Octv_Startin arvoa alennetaan niin paljon, että ehto
  213.    täyttyy.
  214.  
  215. SEE ALSO
  216.  
  217.  
  218. Pkb/MUIA_Pkb_Key_Release
  219.  
  220. NAME
  221.     MUIA_Pkb_Key_Release   -- (V1) [.S.N], ULONG
  222.  
  223. FUNCTION
  224.    Vapauttaa koskettimen.
  225.  
  226. NOTES
  227.    Arvo vaihtelee 0:n ja 131:n välillä ja on riippumaton oktaaviluvusta,
  228.    joka näkyisi alapalkissa.
  229.  
  230. SEE ALSO
  231.    MUIA_Pkb_Octv_Start, MUIA_Pkb_Octv_Range, MUIA_Pkb_Key_Press
  232.  
  233. Pkb/MUIA_Pkb_Key_Press
  234.  
  235. NAME
  236.     MUIA_Pkb_Key_Press   -- (V1) [.S..], ULONG
  237.  
  238. FUNCTION
  239.    Painaa kosketinta.
  240.  
  241. NOTES
  242.    Arvo vaihtelee 0:n ja 131:n välillä ja on riippumaton oktaaviluvusta,
  243.    joka näkyisi alapalkissa.
  244.  
  245. SEE ALSO
  246.    MUIA_Pkb_Octv_Start, MUIA_Pkb_Octv_Range, MUIA_Pkb_Key_Release
  247.  
  248. Pkb/MUIA_Pkb_Range_Head
  249.  
  250. NAME
  251.    MUIA_Pkb_Range_Head   -- (V1) [.SGM], ULONG
  252.  
  253. FUNCTION
  254.    Asettaa tai palauttaa ryhmän johtajan range-tilassa.
  255.  
  256. INPUTS
  257.    MUIV_Pkb_Range_Head_OFF
  258.    MUIV_Pkb_Range_Head_BOT
  259.    MUIV_Pkb_Range_Head_TOP
  260.  
  261. SEE ALSO
  262.    MUIA_Pkb_Mode
  263.  
  264. Pkb/MUIA_Pkb_Range_Start
  265.  
  266. NAME
  267.    MUIA_Pkb_Range_Start   -- (V1) [.SGM], LONG
  268.  
  269. FUNCTION
  270.    Asettaa tai palauttaa VIIMEISEN aktiivisen välin matalimman nuotin arvon.
  271.  
  272. NOTES
  273.    Kun asetat, sinun pitää antaa sallittu positiivinen luku.
  274.    
  275.    Kun saat tämän atribuutin, sinulle palautetaan aina 0:n ja 131:n välillä oleva
  276.    luku, tai -1, jos ei ole aktiivista väliä.
  277.  
  278. SEE ALSO
  279.    MUIA_Pkb_Range_End, MUIA_Pkb_Mode
  280.  
  281. Pkb/MUIA_Pkb_Range_End
  282.  
  283. NAME
  284.    MUIA_Pkb_Range_End   -- (V1) [.SGM], LONG
  285.  
  286. FUNCTION
  287.    Asettaa tai palauttaa VIIMEISEN aktiivisen välin korkeimman nuotin arvon.
  288.  
  289. NOTES
  290.    Kun asetat, sinun pitää antaa sallittu positiivinen luku.
  291.  
  292.    Kun saat tämän atribuutin, sinulle palautetaan aina 0:n ja 131:n välillä oleva
  293.    luku, tai -1, jos ei ole aktiivista väliä.
  294.  
  295. SEE ALSO
  296.    MUIA_Pkb_Range_Start, MUIA_Pkb_Mode
  297.  
  298. Pkb/MUIA_Pkb_Low
  299.  
  300. NAME
  301.    MUIA_Pkb_Low   -- (V1) [..G.], ULONG
  302.  
  303. FUNCTION
  304.    Palauttaa koskettimiston alimman nuotin arvon.
  305.  
  306. SEE ALSO
  307.    MUIA_Pkb_High
  308.  
  309. Pkb/MUIA_Pkb_High
  310.  
  311. NAME
  312.    MUIA_Pkb_High   -- (V1) [..G.], ULONG
  313.  
  314. FUNCTION
  315.    Palauttaa koskettimiston korkeimman nuotin arvon.
  316.  
  317. SEE ALSO
  318.    MUIA_Pkb_Low
  319.  
  320. Pkb/MUIM_Pkb_Reset
  321.  
  322. NAME
  323.    MUIM_Pkb_Reset
  324.  
  325. SYNOPSIS
  326.    DoMethod(obj, MUIM_Pkb_Reset);
  327.  
  328. FUNCTION
  329.    Resetoi koskettimiston vapauttamalla kaikki koskettimet.
  330.  
  331. SEE ALSO
  332.  
  333.  
  334. Pkb/MUIM_Pkb_Refresh
  335.  
  336. NAME
  337.    MUIM_Pkb_Refresh  -- (V1)
  338.  
  339. SYNOPSIS
  340.    DoMethod(obj, MUIM_Pkb_Refresh);
  341.  
  342. FUNCTION
  343.    Piirtää koskettimiston uudelleen.
  344.  
  345. NOTES
  346.    Täma tapa voi olla tarpeellinen, jos jotain muutoksia on tehty,
  347.    kun koskettimiston MUIA_Pkb_Quiet oli asetettu TODEKSI.
  348.  
  349. SEE ALSO
  350.    MUIA_Pkb_Quiet
  351.  
  352. Pkb/MUIM_Pkb_Range
  353.  
  354. NAME
  355.    MUIM_Pkb_Range  -- (V1)
  356.  
  357. SYNOPSIS
  358.    DoMethod(obj, MUIM_Pkb_Range, ULONG nstart, ULONG nend);
  359.  
  360. FUNCTION
  361.    Luo välin arvojen nstart ja nend välille.
  362.  
  363. NOTES
  364.    nstart arvon ei välttämättä tarvitse olla pienempi kuin nend, mutta
  365.    ne molemmat pitää asettaa välille 0...131.
  366.  
  367. SEE ALSO
  368.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  369.  
  370. Pkb/MUIM_Pkb_Range_Reset
  371.  
  372. NAME
  373.    MUIM_Pkb_Range_Reset  -- (V1)
  374.  
  375. SYNOPSIS
  376.    DoMethod(obj, MUIM_Pkb_Range_Reset);
  377.  
  378. FUNCTION
  379.    Resetoi VIIMEISEN aktiivisen välin, jolloin kaikki koskettimet, mitkä
  380.    muodostivat välin, vapautuvat.
  381.  
  382. NOTES
  383.    MUIA_Pkb_Range_Start ja MUIA_Pkb_Range_End atribuutit resetoituvat
  384.    tämän metodin kutsumisen jälkeen.
  385.  
  386. SEE ALSO
  387.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  388.  
  389. Pkb/MUIM_Pkb_Range_Refresh
  390.  
  391. NAME
  392.    MUIM_Pkb_Range_Refresh  -- (V1)
  393.  
  394. SYNOPSIS
  395.    DoMethod(obj, MUIM_Pkb_Range_Refresh);
  396.  
  397. FUNCTION
  398.    
  399.    Virkistää aktiivisen välin, joka on ryhmä nuotteja, jotka ovat
  400.    MUIA_Pkb_Range_Startin ja MUIA_PKb_Range_Endin välissä.
  401.  
  402. SEE ALSO
  403.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  404.  
  405. Pkb/MUIM_Pkb_Jump
  406.  
  407. NAME
  408.    MUIM_Pkb_Jump  -- (V1)
  409.  
  410. SYNOPSIS
  411.    DoMethod(obj, MUIM_Pkb_Jump, ULONG ncode);
  412.  
  413. FUNCTION
  414.    Hyppää ncoden mukaiselle nuotille, tehden sen näkyväksi.
  415.  
  416. NOTES
  417.    ncode arvon pitää olla joku koskettimistolta, eli arvo MUIA_Pkb_Low:n
  418.    ja MUIA_Pkb_High:n väliltä
  419.  
  420. SEE ALSO
  421.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  422.  
  423. Pkb.mcc/MUIA_Pkb_InputEnable
  424.  
  425. NAME
  426.    MUIA_Pkb_InputEnable   -- (V14.4) [ISG], BOOL
  427.  
  428. FUNCTION
  429.    Sallii tai estää koskettimiston käytön käyttäjältä.
  430.  
  431. INPUTS
  432.    TOSI   (oletus)
  433.    EPÄTOSI
  434.  
  435. NOTES
  436.      Aseta tämä atribuutti, jos haluat estää koskettimistoa reagoimasta
  437.      hiiren painalluksiin.
  438.  
  439.      Kun asetat MUIA_Pkb_Quiet:n TODEKSI, koskettimisto TUNTUU reagoivan,
  440.      vaikka koskettimia ei päivitetä, mutta atribuutit, joiden tila riippuu
  441.      koskettimien painamisesta ja vapauttamisesta - kuten MUIA_Pkb_Key_Release,
  442.      MUIA_Pkb_Key_Press jne. - päivitetään.
  443.  
  444. SEE ALSO
  445.    MUIA_Pkb_Quiet
  446.  
  447. Pkb.mcc/MUIA_Pkb_ExcludeLow
  448.  
  449. NAME
  450.    MUIA_Pkb_ExcludeLow   -- (V14.4) [ISG], ULONG
  451.  
  452. FUNCTION
  453.    Asettaa tai palauttaa poisjätettyjen sävelpuolikkaiden määrän koskettimiston
  454.    alapäästä.
  455.  
  456. INPUTS
  457.         0 : ei poisjätettyjä koskettimia  (oletus)
  458.    1...11 : jätetty pois C...Bb
  459.  
  460. NOTES
  461.    Pkb luokka EI VOI piirtää epätäydellisiä oktaaveja.
  462.    Kuitenkin joskus tarvitaan koskettimistoa, joka alkaa jollain muulla
  463.    kuin C-nuotilla.
  464.    Tämä on mahdollista, kun asetat MUIA_Pkb_ExcludeLow:n tarvittavan määrän
  465.    sävelpuolikkaita.
  466.    Poisjätetyt koskettimet piirretään joka tapauksessa, mutta ne ovat
  467.    eri värisiä, eikä niillä ole mitään toimintoa.
  468.  
  469. SEE ALSO
  470.    MUIA_Pkb_ExcludeHigh
  471.  
  472. Pkb.mcc/MUIA_Pkb_ExcludeHigh
  473.  
  474. NAME
  475.    MUIA_Pkb_ExcludeHigh   -- (V14.4) [ISG], ULONG
  476.  
  477. FUNCTION
  478.    Asettaa tai palauttaa poisjätettyjen sävelpuolikkaiden määrän koskettimiston
  479.    yläpäästä.
  480.  
  481. INPUTS
  482.         0 : ei poisjätettyjä koskettimia  (oletus)
  483.    1...11 : jätetty pois B...Db
  484.  
  485. NOTES
  486.    Pkb luokka EI VOI piirtää epätäydellisiä oktaaveja.
  487.    Kuitenkin joskus tarvitaan koskettimistoa, joka päättyy johonkin muuhun
  488.    kuin B-nuottiin.
  489.    Tämä on mahdollista, kun asetat MUIA_Pkb_ExcludeHigh:n tarvittavan määrän
  490.    sävelpuolikkaita.
  491.    Poisjätetyt koskettimet piirretään joka tapauksessa, mutta ne ovat
  492.    eri värisiä, eikä niillä ole mitään toimintoa.
  493.  
  494. SEE ALSO
  495.    MUIA_Pkb_ExcludeLow
  496.  
  497.